home *** CD-ROM | disk | FTP | other *** search
/ Beginning Mac Programming / Beginning Mac Programming.bin / pc / Open Me for REALbasic 3 / REALbasic 3.2 / Goodies / 3rd Party Demos / 3rd Party Plugins / eSelleratePlugin for REALbasic / ReadMe < prev   
Encoding:
Text File  |  2001-01-19  |  3.2 KB  |  134 lines
  1. ReadMe
  2.  
  3.    eSellerate Plug-in for REALbasic
  4.  
  5.    Copyright 2001
  6.    MindVision Software
  7.    5901 N. 58th St.  
  8.    Lincoln NE 68507-3249
  9.    www.mindvision.com
  10.    www.esellerate.net
  11.  
  12.    WHAT IS ESELLERATE?
  13.  
  14. eSellerate is the e-commerce company with comprehensive
  15. solutions designed especially for software publishers.
  16.  
  17. eSellerate puts the power of instant software purchase and
  18. fulfillment in the hands of your customers. Now, you can
  19. sell software directly to your customers from:
  20.  
  21.  - Inside your application using Integrated eSellers
  22.  - Inside your installer using Installer eSellers
  23.  - A full-featured online store using Web Store eSellers
  24.  
  25.    WHAT IS AN INTEGRATED ESELLER?
  26.  
  27. One of the most powerful ways to sell with eSellerate is to
  28. integrate it directly into your software application. When
  29. you turn your application into an Integrated eSeller, your
  30. customers can:
  31.  
  32.  - Purchase the retail version of your product directly from
  33.    a demo version
  34.  - Use your retail software to check for newer versions, and
  35.    upgrade directly from your application when a newer
  36.    version becomes available. These new versions can be free
  37.    or purchased upgrades
  38.  
  39.    WHAT IS THE ESELLERATE PLUG-IN FOR?
  40.  
  41. Just drop the eSelleratePlugin file into REALbasic's Plugins
  42. folder, and you now have the capabilty enable and command an
  43. Integrated eSeller from inside your REALbasic application.
  44.  
  45. The eSeller is powered by the eSellerateEngine file, which
  46. must reside in the MindVision folder of your application
  47. user's Extensions folder. Dropping eSellerateEngine into
  48. Extensions does not require a restart to activate it.
  49.  
  50.    HOW DO I LEARN TO USE THE ESELLERATE PLUG-IN?
  51.  
  52. Double-click the eSellerateInstaller file provided. It will
  53. install eSelleratePlugin and eSellerateEngine to their
  54. proper locations. It will also create a folder that contains
  55. a users guide and a sample REALbasic application. Read the
  56. ReadMe file that accompanies these.
  57.  
  58.    WHAT DOES THE API PROVIDED BY THE PLUG-IN LOOK LIKE?
  59.  
  60. The methods that comprise the Application Programmers
  61. Interface are listed below. The use of these methods is
  62. described in the eSellerate Users Guide file and illustrated
  63. in the GeckoSoft Project file of the sample application.
  64.  
  65.   eSeller class methods:
  66.  
  67. Purchase (
  68.   publisherID as String,
  69.   esellerID as String,
  70.   previewID as String,
  71.   errorURL as String
  72. ) as Integer
  73.  
  74. CheckForUpdate (
  75.   publisherID as String,
  76.   esellerID as String,
  77.   previewID as String,
  78.   errorURL as String
  79. ) as Integer
  80.  
  81. GetSerialNumberCount
  82.   as Integer
  83.  
  84. GetSerialNumber (
  85.   index as Integer
  86. ) as String
  87.  
  88. GetNameBasedKey (
  89.   index as Integer
  90. ) as String
  91.  
  92. GetProductID (
  93.   index as Integer
  94. ) as String
  95.  
  96. GetFileLocationCount
  97.   as Integer
  98.  
  99. GetFileLocation (
  100.   index as Integer
  101. ) as FolderItem
  102.  
  103. LaunchUpdate (
  104.   updaterFile as FolderItem,
  105.   fileToUpdate as FolderItem
  106. ) as Integer
  107.  
  108. ValidateSerialNumber (
  109.   serialNumber as String,
  110.   nameBasedKey as String,
  111.   publisherKey as String
  112. ) as Integer
  113.  
  114. TranslateResultCode (
  115.   resultCode as Integer
  116. ) as String
  117.  
  118.   supplemental methods:
  119.  
  120. IdentifyOneself
  121.   as FolderItem
  122.  
  123. GetResource (
  124.   resourceType as String,
  125.   resourceID as Integer
  126. ) as String
  127.  
  128. SetResource (
  129.   resourceType as String,
  130.   resourceID as Integer,
  131.   resourceName as String,
  132.   resourceData as String
  133. ) as Integer
  134.